----------------------------------------------------------------------------------------------------------------
                               TOC Changer v1.2 by Phoenix  (September 2nd 2007)                  
----------------------------------------------------------------------------------------------------------------



##################################################### ITALIAN ##################################################

1) Ma a che cavolo serve?

Questo programma  stato realizzato con l'intento di facilitare e velocizzare l'operazione di espansione dello spazio adibito ad un file all'interno di un ISO di un gioco PSX agendo sulla TOC (Table of Contents) (che frasona!). Operazione molto utile quando si lavora con file, che ricompressi, ad esempio, risultano essere leggermente pi grandi degli originali. Ad ogni modo, potrete trovare ulteriori chiarimenti sul perch fare queste modifiche alla TOC nella "Guida alla modifica della TOC" scritta da Sephiroth 1311 presente su romhacking.it.


2) OK, interessante... ma come si usa?

L'utilizzo di TOC Changer  molto semplice. Esso  suddiviso in tre sezioni:
-Apri un file ISO PSX/PS2
-Parametri
-Calcola dimensione massima consentita (opzionale)

La prima sezione ci consente di scegliere, tramite il tasto "Apri...", su quale file immagine vogliamo modificare la TOC.

La seconda viene utilizzata per specificare al programma quale sar il file di cui vogliamo modificare la dimensione all'interno della TOC, semplicemente scrivendo il suo nome (compresa l'estensione) nel campo ad esso preposto; e la nuova dimensione che dovr avere il file nell'ISO (scrivendo la nuova dimensione in byte).
 anche possibile, invece di inserire il nome e la dimensione a mano, aprire il nuovo file (ad esempio quello appena ricompresso) con il tasto "Cerca file". Una volta selezionato, il tool riempir in automatico i campi.
 possibile attivare l'opzione "Attiva modifica LBA" (per utenti esperti). Quest'opzione  stata ideata proprio con l'intento di poter addirittura spostare (virtualmente) un file all'interno della ISO semplicemente cambiando l'LBA (indirizzo di settore) del file stesso, sfruttando cos spazi inutilizzati all'interno della ISO come i comunissimi file DUMMY (questa opzione  utile nel caso in cui la dimensione massima consentita non fosse sufficiente).
 da notare che, proprio a causa dello scopo per cui essa  preposta, una volta attiva quest'opzione, il tool non controller pi la validit della dimensione, in quanto, cambiando LBA, il file potrebbe essere indirizzato ovunque nella ISO, e quindi avere a disposizione molto pi spazio (infatti lo scopo  proprio questo).
N.B. Ho scritto "virtualmente" perch solo l'indirizzo del file viene modificato, ma fin quando non verr fatto un inserimento del file all'interno dell'ISO con la nuova TOC, i dati presenti a quell'LBA resteranno invariati.
 
La terza invece,  una sezione opzionale, cio non influenzer in alcun modo le modifiche alla TOC, infatti basta solo riempire i campi della prima e della seconda sezione e si pu benissimo cliccare sul tasto "Change IT".
Questa sezione aiuta l'utente, calcolando automaticamente quale sar la dimensione massima consentita dalla TOC per il nuovo file, basandosi esclusivamente sulla dimensione del file originale. Anche qui  possibile velocizzare le operazioni, avvalendosi del tasto "Cerca file" con il quale si potr caricare il file originale, in modo tale che il tool calcoli in automatico la dimensione massima consentita.


3) Mmm, mi piace, e a che versione sei? (ora sto esagerando XD )

La versione del tool  la 1.2 e implementa tutte le seguenti caratteristiche:

Versione 1.2:

-Aggiunto l'algoritmo di rigenerazione dei codici ECC/EDC per le iso PSX (grazie Agemo per i sorgenti)
-Aggiunto il supporto per le iso di giochi PS2.
-Aggiunta una StringTable al sorgente in modo da rendere il tool multilingua in maniera pi semplice e veloce.

Versione 1.1a:

-Correzione di un bug noioso dovuto alla lunghezza del nome del file da modificare (grazie Sephiroth 1311 per la  segnalazione

Versione 1.1:

-Possibilit di modificare, oltre alla dimensione, l'LBA del file, attivando la check box apposita.

Versione 1.0:

-Algoritmo di ricerca e di modifica della TOC (abbastanza veloce, 50-60 sec per scansionare per intero 700 MB).
-Controllo sul file trovato e conseguente richiesta di modifica o di nuova ricerca, per evitare omonimia tra i file.
-Controllo sul file trovato ed eventuale avvertimento, in caso la nuova dimensione non fosse accettabile.
-Possibilit di selezionare direttamente un file da disco fisso in modo da caricare immediatamente le informazioni per la modifica della TOC.
-Calcolatore per la dimensione massima consentita implementato nella GUI principale (grazie Sephiroth 1311).
-Possibilit di caricare direttamente un file (Calcolatore dimensione max) in modo da ottenere subito le informazioni sulla dimensione max.
-Possibilit di annullare la ricerca in qualunque momento (ora la sto tirando per le lunghe XD ).
-Vari controlli sulle textbox lasciate in bianco o su cosa c' scritto dentro.


4) Bello bello, voglio un abbonamento mensile per i nuovi aggiornamenti!

Si spera che nella prossima release verranno implementate le seguenti caratteristiche:

-Migliore algoritmo di ricerca dei file.
-Possibilit di inserire i nuovi file nella iso.


5) Riconoscimenti

Ringrazio innanzi tutto Gemini per essere stato il mio "Guru" e per avermi fatto conoscere il mondo delle MFC, grazie alle quali sono riuscito a scrivere il tool. Un grazie va anche a Sephirtoh 1311 che mi ha spronato nel migliorare il tool, visto che in precedenza ne scrissi uno moolto ma moolto grezzo che rilasciai solo a lui in occasione della traduzione di Vagrant Story. Grazie ad Agemo per aver rilasciato i suoi sorgenti sul'algoritmo degli ECC/EDC. Infine, un GRAZIE a romhacking.it, perch frequentandolo, a poco a poco sono riuscito a migliorare e ad arrivare fino a questo punto. Bye bye e (si spera) alla prossima! XD.

##################################################### ITALIAN #####################################################




###################################################### ENGLISH #####################################################


1) What the hell is it?

This tool is useful if you want to edit file information (like size and LBA) stored in the TOC (Table of Contents) of a PSX/PS2 iso file. You can use this tool if you want to reinsert a file in your iso image and the file you want to reinsert is bigger the the original one (for example you recompressed it after editing it). Just change the file size in the TOC of the iso and then reinsert it with an ISO editor like CDMAGE. I'll be more detailed in section 2.
You can learn more about TOC editing by reading the TOC changing guide wrote by Sephiroth 1311 (it's all in italian :P). You can find it at www.romhacking.it


2) OK, it's cool... but, how does it work??

TOC Changer's usage is really simple. It's made up of three sections:
-Open a PSX/PS2 image
-Parameters
-Calculate max size allowed (optional)

The first section allow us to select a PSX/PS2 iso file wich will be modified by my tool.

The second one is used to specify to the tool what is the name of the file (with extension) that you want to edit into the TOC and the new size (in bytes) of the file.
You can also specify the file name and the size by clicking the button "Browse...". Once you selected your file (for example the new recompressed file), TOC Changer will fill the TextBox for you ;).
You can also enable the option "Enable LBA change option" (advanced users). Use this option if your file is too big and the size expansion is not enough. By changing the LBA you can virtually move a file wherever you want inside the iso (for example redirecting the file in the same sectors of a DUMMY FILE).
It's important to say that enabling this otpion, TOC Changer will not warn you about the max size limit, because if you change the file position inside the iso, might be more space availabe (for example DUMMY FILE are 30-40mb big), so if you use this option, you should know what you are doing ;).
Note: I wrote "virtually" because, although you change the LBA in the iso, only if you reinsert the new file in the edited iso, the sectors referred by that LBA will contain the new file.
 
The third section is an optional section, in fact you can fill the first and second section's TextBox and click "Change IT".
This section will help the user to know how big can be the max size allowed for your new file simply writing in the TextBox the original file size.
By the way, in this section you can also select your ORIGINAL file by clicking the button "Browse..." and TOC Changer will calculate it for you.

3) Mmm, I like it. What about the version? (Now I'm exaggerating XD )

The tool's version is 1.2 and implements the following features:

Version 1.2:

-Added ECC/EDC regeneration code algorithm (thanks to Agemo for the source code).
-Added support for PS2 isos.
-Added a StringTable to the source code to make the multilanguage feature easly and quickly.

Version 1.1a:

-Corrected an annoying bug about File name's length (Thanks to Sephiroth 1311).

Version 1.1:

-Now you can also change the LBA of the file, just enable the option "Enable LBA change option".

Version 1.0:

-TOC find/edit algorithm implemented (quite rapid, 50-60 secs to scan 700mb isos).
-File found check implemented. The tool will prompt you if you want to find a file with the same name. There can be more files with the same names.
-Invalid new File Size check implemented. The user will be prompted with a message box.
-Now you can select your new file by clicking the "Browse..." button.
-New max size allowed Calculator implemented in the GUI (Thanks to Sephiroth 1311).
-Know you can select your original file by clicking the "Browse..." button.
-"Cancel" button added. You can stop the process whenever you want (Now I'm really boring you XD ).
-Added some checks that will prompt you if you didn't fill all the TextBoxes.


4) WOW, VERY COOL. I want a monthly subscription for updates!

I hope I will implement the following features in the new version:

-Better TOC find/edit algorithm.
-File insertion option.


5) Credits
Thanks to Gemini because he was my "Guru" in MFC programming, and if you didn't get it, TOC Changer is a MFC application ;). Thanks to Sephiroth 1331 wich encouraged me to improve my tool. In fact I released a very beta version of this tool only to him for the Vagrant Story transaltion project. Thanks to Agemo wich released his ECC/EDC source code. And the last but not the least, thanks to all guys of romhacking.it because thanks to them, I learnt to program and write this tool.
Bye bye. (I hope) See you for the next release! XD.


################################################### ENGLISH ########################################################


Phoenix.